.\"   $Id: GENLIB_DEF_PHINS.3,v 1.1 2002/03/08 14:08:10 fred Exp $
.\" @(#)GENLIB_DEF_PHINS.3 2.11 91/08/22; Labo Cao-vlsi; Author : Frederic Petrot
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
GENLIB_DEF_PHINS
.XE \}
.TH GENLIB_DEF_PHINS.3 "October 1, 1997" "ASIM/LIP6" "PROCEDURAL GENERATION LANGUAGE"
.SH NAME
GENLIB_DEF_PHINS \- define a new reference instance
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
void GENLIB_DEF_PHINS(instancename);
char \(**instancename;
.ft R
.fi
.so man1/alc_origin.1
.SH PARAMETERS
.TP 20
\fIinstancename\fP
Defines the instance called \fIinstancename\fP as the new "reference instance" 
.SH DESCRIPTION
\fBDEF_PHINS\fP define the new "reference instance", used as starting point
in the relative placement functions of genlib. It's regarding the \fBabutment
box\fP of the instance \fIinstancename\fP that the next instance is going to be
placed, if using the appropriate functions. Notice that the more recently
placed instance becomes automatically the "reference instance", if 
\fBDEF_PHINS\fP isn't called.
.SH ERRORS
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"GENLIB_DEF_PHINS impossible : missing GENLIB_DEF_PHFIG"
.ft R
.RS
No figure has been yet specified by a call to \fBDEF_PHFIG\fP. So it isn't
possible to refer to an instance inside it.
you must call \fBDEF_PHFIG\fP before any other layout action.
.RE
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
"instance instancename doesn't exist in current figure"
.ft R
.RS
The instance \fIinstancename\fP hasn't currently been placed in the figure,
so it's impossible do to any placement from it. 
.RE
.SH EXAMPLE
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
main()
{
	/\(** Create a figure to work on  \(**/
	GENLIB_DEF_PHFIG("cell");
	/\(** Place an instance \(**/
	GENLIB_PLACE("model","i1", NOSYM,0L,0L);
	GENLIB_PLACE("model","i2", NOSYM,120L,40L);
	GENLIB_DEF_PHINS("i1");
	GENLIB_PLACE_TOP("model2", "i3", NOSYM);
	GENLIB_DEF_AB(0, 0, 0, 0);
	/\(** Save all that on disk \(**/
	GENLIB_SAVE_PHFIG();
}
.ft R
.fi
.SH SEE ALSO
.BR genlib (1),
.BR GENLIB_PLACE (3),
.BR GENLIB_PLACE_TOP (3),
.BR GENLIB_PLACE_RIGHT (3),
.BR GENLIB_PLACE_LEFT (3),
.BR GENLIB_PLACE_BOTTOM (3),
.BR GENLIB_SC_PLACE (3),
.BR GENLIB_SC_TOP (3),
.BR GENLIB_SC_RIGHT (3),
.BR GENLIB_SC_LEFT (3),
.BR GENLIB_SC_BOTTOM (3).


.so man1/alc_bug_report.1

